Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
This PR contains the following updates:
^2.1.1
->9.1.1
Release Notes
puppeteer/puppeteer
v9.1.1
Compare Source
v9.1.0
Compare Source
Features
Bug Fixes
v9.0.0
Compare Source
⚠ BREAKING CHANGES
Features
Bug Fixes
This PR contains the following updates:
^2.1.1
->9.1.1
and
$
selectors generic (#6883) (b349c91)v8.0.0
Compare Source
⚠ BREAKING CHANGES
ChromeArgOptions
toBrowserLaunchArgumentOptions
BrowserOptions
toBrowserConnectOptions
Features
Bug Fixes
Viewport
type (#6881) (be7c229)v7.1.0
Compare Source
Features
Bug Fixes
ScreenshotOptions
type in type defs (#6869) (63d48b2), closes #68667.0.4 (2021-02-09)
Bug Fixes
7.0.3 (2021-02-09)
Bug Fixes
7.0.2 (2021-02-09)
Bug Fixes
7.0.1 (2021-02-04)
Bug Fixes
v7.0.4
Compare Source
v7.0.3
Compare Source
v7.0.2
Compare Source
v7.0.1
Compare Source
v7.0.0
Compare Source
⚠ BREAKING CHANGES
page.screenshot
makes a screenshot with the clip dimensions, not cutting it by the ViewPort size.page.screenshot
cuts screenshot content by the ViewPort size, not ViewPort position.Features
captureBeyondViewport
inPage.captureScreenshot
(#6805) (401d84e)v6.0.0
Compare Source
⚠ BREAKING CHANGES
aria/
selector query handler doesn’t return ignored elements anymore.Features
Bug Fixes
ERR_INVALID_PROTOCOL
(#6555) (3bf5a55)v5.5.0
Compare Source
Features
Bug Fixes
_isClosedPromise
(#6579) (122f074)v5.4.1
Compare Source
Bug fixes
fs.promises
would throw an error. See #6548 for the bug report and #6550 for the fix. We now run a CI build on Node 10.15 to ensure we don't cause similar regressions in the future.Raw notes
520cd90
- chore: mark version 5.4.18f4a79e
- docs(troubleshooting): update Alpine Chromium version (#6529)e45acce
- chore: run unit tests on node 10.15 + fix fs.promises access (#6550)a2175c6
- docs(queryhandler): fix link (#6543)d787865
- chore: bump version to v5.4.0-post (#6544)v5.4.0
Compare Source
Feature changes
Custom query handler API
The custom query handler support is no longer marked as experimental. The API has been updated to:
New built-in query handlers
Puppeteer now ships with two built-in handlers:
aria
andpierce
:aria
handler (#6307) allows querying elements based on the accessibility tree.pierce
handler (#6509) pierces shadow roots while querying for a CSS selector.Roll Chromium 87.0.4272.0 (r809590)
Behind the scenes
Raw notes
5e5fed1
- fix: ignore spurious bindingCalled events (#6538)e6b8c77
- chore: fix travis config (#6537)c756fb4
- fix(utils): typo fix (#6522)f63a123
- chore(agnostification): agnostify web socket connections (#6520)c2c2bb7
- chore(agnostification): common/helper.ts (#6515)637a1f7
- chore: gitignore new-docs (#6511)e655bb6
- chore(agnostification): split up root Puppeteer class (#6504)f3086d7
- fix(launcher): support relative userDataDir on headless Windows (#6506)8fabe32
- feat(queryhandler): add built-in pierce handler (#6509)f04bec5
- chore: update eslint & eslint plugins (#6487)4846b87
- chore(agnostification): split up launcher class (#6484)1ed38af
- chore(node): move install.ts into node/ (#6490)e94a1e8
- chore: bump misc dependencies (#6488)936ccdc
- chore: enforce Conventional Commits through commitlint (#6483)502ed8c
- chore(agnostify): Create Node and Web initializer. (#6477)3afe193
- feat(a11y-query): extend aria handler with waitFor (#6472)cc7f1fd
- docs(queryhandler): add custom query handler docs (#6476)70ed875
- fix(queryhandler) only expose custom handlers (#6475)950ae33
- feat(a11y-query): aria query handler sans waitfor (#6459)41ef3ee
- fix: update preferences in default Firefox profile (#6465)9275653
- docs(examples): update selector for search example (#6471)49f25e2
- feat(chromium) roll Chromium to r809590 (#6458)4cdbebe
- chore: disable firefox windows launcher test until Nov (#6451)75e3fb0
- docs(api): fix some outdated links (#6450)caa9a1c
- chore(agnostic): Remove use of util.promisify (#6446)96f3d43
- feat(console): expose stack trace for console messages (#6445)322cc96
- chore: remove npm run test-types call (#6447)72fe86f
- feat(a11y-query): introduce internal handlers (#6437)1396c9d
- chore: bump version to v5.3.1-post (#6440)11ab402
- fix: add mime dependency back to fix build (#6441)v5.3.1
Compare Source
Highlights
page.emulateIdleState(...)
(#6410)Raw notes
c7d32cb
- chore: mark version v5.3.1 (#6439)8f3171a
- feat(permissions): Add idle-detection permission (#6438)083ea41
- test(frame): correct terminology in URL fragment test (#6416)bb1c521
- chore: remove mime dependency (#6415)17960e5
- feat(page): emulate idle state (#6410)03e41da
- chore: bump version to v5.3.0-post (#6413)v5.3.0
Compare Source
Highlights
PUPPETEER_DOWNLOAD_PATH
(#6014)page.waitForTimeout
and subsequently,frame.waitForTimeout
(#6268)page.waitFor
andframe.waitFor
(#6268)Raw notes
030fcaa
- chore: mark version v5.3.0 (#6412)4ce600a
- chore: Remove target debug-unit and add unit-debug (#6411)62ac167
- feat(chromium): roll Chromium to r800071 (#6407)35cfbe1
- docs(troubleshooting.md): updated commands (#6296)ce6ae35
- doc(contributing): add info on bisecting upstream changes (#6402)e22ca4c
- chore: extend Firefox launch test deadline by a month (#6403)2470d1e
- chore: update documentation on rolling chromium (#6399)b6bbfd0
- fix: ensure frame.url() includes the query string (#6398)7b24e54
- fix: revise interesting classification for AXNodes (#6334)13ea347
- feat: support configuring the browser download path (#6014)615cd37
- chore: use https URL for license info (#6279)b4c1e45
- docs: fix setuid sandbox link (#6310)054d782
- fix(Launcher): use wait-for-process Firefox option (#6315)996e82c
- test(install): check for Firefox binary, clean up messages (#6316)142f88c
- docs(troubleshooting): update Alpine Chromium version (#6320)8e29b7a
- chore: rename serializeTree parameter (#6308)1d08e27
- docs(troubleshooting.md) fix error in docker guidelines (#6267)9bc063b
- chore: assert location value of ConsoleMessage in tests (#6282)713e990
- chore: upgrade Mitt to 2.1 (#6287)21552f8
- feat: page.waitForTimeout (#6268)3a15c06
- chore: test Connection class in the browser (#6269)a47b556
- docs(api): fix typo in elementHandle.evaluateHandle() (#6276)8c1a586
- fix: handle promise for reading protocol stream of trace (#6270)15d1906
- feat: add web test runner (#6200)13f8fe6
- chore(docs):page.emulateVisionDeficiency
docs (#6231)e3933dd
- chore: mark 5.2.1-post (#6257)v5.2.1
Compare Source
Highlights
globalThis.__PUPPETEER_DEBUG
(#6210)Raw notes
4ee4649
- chore: mark v5.2.1 (#6254)e89e264
- feat(chromium): roll Chromium to r782078 (#6250)b2f6918
- fix: configure debug logging in browser (#6210)040f37e
- docs: fix link text (#6245)9fdf2ba
- chore(docs): migrate page.pdf() docs (#6228)2331584
- docs(troubleshooting): install libXss in Dockerfile (#6236)042c4a2
- chore: mark 5.2.0-post (#6240)v5.2.0
Compare Source
Feature changes
The experimental API for registering custom query handlers is slightly changed such that one registers query handlers containing two strategies: one for querying a single element and one for querying all matching elements.
The API for custom query handlers is unchanged:
but QueryHandler is now defined as:
Bug fixes and improvements
Raw notes
028f144
- chore: mark v5.2.0 (#6238)313774c
- feat: change QueryHandler to contain QueryOne and QueryAll methods (#6218)82645e8
- docs: better describe how to install Firefox Nightly with Puppeteer (#6226)f1a6b8d
- chore: vendor Mitt & update project structure (#6209)fb80610
- docs(troubleshooting): drops obsolete dependencies (#5354)3effcaf
- chore: generate docs for the protocol (#6213)ffec247
- chore: enforce file extensions on imports (#6202)8d6e0d8
- chore: mark version to v5.1.0-post (#6208)v5.1.0
Compare Source
Highlights:
The new
Mouse#wheel
API has been merged in #6141. It behaves similar to other mouse commands like up or down and therefore requires amouse.move(x, y)
for targeting the element properly.Raw notes:
91c13d2
- chore: mark version v5.1.0790c277
- feat(chromium): roll Chromium to r768783 (#6201)9b3005c
- feat(types): improve page.evaluate types (#6193)31309b0
- chore: use devtools-protocol package (#6172)f666be3
- chore: remove src/api.ts (#6191)03a87e8
- chore(docs): tidy Puppeteer class docs (#6181)24cb6a2
- chore(docs): document Frame class (#6188)b9667f9
- chore: document browser install breakage on Node 14.0.0 (#6187)1243466
- chore: removeinstallAsyncStackHooks
helper (#6186)19f188a
- chore: forbid importing src/common/Events.ts (#6183)0e93880
- chore(docs): migrate Connection + CDP event defs (#6180)74cb2ce
- chore: migrate FrameManager events from Events.ts (#6179)6ee7139
- chore(docs): fix incorrect@returns
on getter (#6175)12ee70f
- chore: migrate NetworkManager events (#6174)022495b
- chore: fix broken link in docs to DeviceDescriptors (#6170)2256b8d
- chore(docs): migrateBrowserContext
events (#6168)e2e0502
- chore(docs): fix DOMWorld doc warnings (#6166)782c1d4
- chore(docs): define events enum forBrowser
(#6165)ba7624a
- chore(docs): migrate & document all Page events (#6154)e67a860
- feat: add Mouse#wheel (#6141)5049b83
- feat(types): add types forpage.$eval
(#6139)f7857d2
- chore(docs): document HTTPRequest with TSDoc (#6146)4ebf117
- docs: migrating Page.ts to TSDoc (#6152)d9bb52e
- docs: fix sandboxing documentation link (#5288)aee8fda
- fix: make Node.js environment detection robust w.r.t. JSDOM (#6148)054fa2e
- chore(docs): fix more documentation warnings (#6145)928924e
- chore: mark v5.0.0-post (#6144)v5.0.0
Compare Source
Breaking changes
Removal of
page.emulateMedia
(#6084)This method was deprecated and is now removed from Puppeteer. Swap to
page.emulateMediaType
which behaves identically.Removal of
require('puppeteer/DeviceDescriptors')
(#6043)This top level file has been removed from the Puppeteer package. The same data is exposed via
puppeteer.devices
, so swap to that:Removal of
require('puppeteer/Errors')
(#6043)This top level file has been removed from the Puppeteer package. The same data is exposed via
puppeteer.errors
, so swap to that:Behind the scenes
We've continued our drive to migrate to a new documentation system using TSDoc. These docs are available in the
new-docs
directory on GitHub. These aren't ready for use just yet but we're making great progress. You can track this work in #6118.We've continued improving our TypeScript definitions. Our tests are now migrated to TypeScript (#5830) so that we're consuming our own API. Work continues to ship built-in type definitions in a future version. You can track this work in #6124.
We've started restructuring Puppeteer to work towards being able to better support an environment agnostic Puppeteer module. You can track this work in #6125.
Raw notes
85d8dbf
- chore: mark v5.0.029f7e16
- chore(docs): reduce warnings when generating docs (#6138)221d172
- chore: add typecheck command (#6140)6474edb
- feat(types): add types for$eval
(#6135)8370ec8
- feat(types): add (and fix)evaluateHandle
types (#6130)3c0dc45
- chore: update Windows skipped tests. (#6133)9f19862
- chore(docs): mark JSHandle properties as internal (#6126)8026ca9
- docs(api): fix overview diagram for pptr.dev (#6128)9d79cc8
- chore: fix Firefox install checker (#6129)1f5e333
- chore: Don't store revisions inpackage.json
(#6109)123c377
- docs(new): Add TSDoc to Coverage class (#6106)3760302
- docs(api): fix broken links in api.md (#6113)adeffba
- docs(new): migrate Page.ts to TSDoc (part 0 / 2) (#6104)df96f16
- docs(new): migrate JSHandle docs to TSDoc (#6102)1c0009d
- chore(agnostic): ship CJS and ESM builds (#6095)46fc6ca
- feat(types): improve typing of.evaluate()
(#6096)a4d12a2
- chore: removehelper.promisify
(#6100)5b6d2bf
- docs(new): add TSDoc comments to Keyboard (#6099)4696f7a
- docs(new): migrate HTTPResponse docs to TSDoc (#6085)b993adb
- chore(agnostic): Migrate DOMWorld (#6054)c149034
- chore: remove hardcoded?hl=en
from docs (#6097)48c5a8e
- docs(new): add TSDoc comments to Puppeteer (#6032) (#6094)f1f7339
- docs(new): add TSDoc comments to Puppeteer (#6032)a46c78f
- docs(new): Adds TSDoc to Tracing class (#6088)60904da
- docs(new): migrate FileChooser docs to TSDoc (#6092)7855519
- chore: tidy up TODO from TS tests migration (#6090)f481922
- docs(new): Adds TSDoc to Mouse class (#6086)2ad42dc
- docs(new): migrate Touchscreen docs to TSDoc (#6087)73b9795
- docs(new): add TSDoc comments to BrowserFetcher (#6078)37f6032
- feat(api): removeemulateMedia
method (#6084)1ee379c
- chore: avoid disabling prettier (#6079)381b0f8
- chore: declaretoBeGolden
to TypeScript (#6080)70a900e
- chore: fix ESLint violation and lessen rule strictness (#6081)fdc6fda
- docs: fix effect -> affect typos (#5985)4659ee8
- docs(new): add TSDoc comments to BrowserContext (#6066)ccae546
- docs(new): migrate Browser docs to TSDoc (#6070)28797de
- chore: migrate tests to TypeScript (#6075)2090676
- docs: fix broken link to DeviceDescriptors.ts (#6076)6657364
- docs(new): migrate ElementHandle to TSDoc (#6073)7025f1c
- docs(new): migrate Target to TSDoc (#6067)819afbe
- docs(new): migrate ConsoleMessage docs to TSDoc (#6065)983a7b6
- docs(new): migrate CDPSession to TSDoc (#6064)1cf3f06
- docs(new): migrate TimeoutError to TSDoc (#6062)ace31d6
- chore: pin TSDoc related dependencies (#6063)750f5ee
- docs: fix broken link to USKeyboardLayout file (#6059)e7b91a7
- chore: enforce a max line length on comments (#6055)7978315
- docs(new): migrate SecurityDetails docs to TSDoc (#6053)7a4170f
- chore: remove top level errors and DeviceDescriptors (#6043)5ff698e
- chore: moveindex.js
intosrc
and TS-ify (#6049)940a570
- chore: exclude api.ts from dependency graph (#6052)759b280
- chore: upgrade to Mocha v8 (#5997)9522f80
- chore: createcommon
directory (#6042)f6af7b8
- chore: fix dependency chart generation (#6039)90b0934
- chore: createnode
directory for Node-only files (#6041)ce34c0a
- fix:page.goto
options type should be optional (#6038)44402b7
- feat(new-docs): add tsdoc comments toWebWorker
(#6029)64c9c70
- chore: add dependency chart generation as script (#6034)547f4ea
- chore: create new debug module (#6028)56742eb
- chore: bump version to v4.0.0-post (#6024)e4de5f1
- chore: moveassert
into its own module (#6021)f1ec6a3
- chore: update references to branch names (#6022)v4.0.1
Compare Source
Bug fixes
main
branch, not the removedmaster
branch. Fixes #6082.Raw notes
16972ca
- pull in master => main renamingb537a67
- chore: mark v4.0.1v4.0.0
Compare Source
Breaking change: Puppeteer no longer uses Node’s EventEmitter library
As part of our work to make Puppeteer agnostic of its environment we are removing the dependency on Node’s EventEmitter in favour of an event emitter that is not tied to Node. Under the hood we use Mitt, but we extend Mitt with additional functionality to match most of the methods that Node’s EventEmitter provides. The following methods have been removed from Puppeteer classes that extend EventEmitter:
eventNames()
getMaxListeners()
listeners(eventName)
prependListener
prependOnceListener
setMaxListeners(n)
rawListeners(eventName)
Additionally all the static methods on the EventEmitter class are not supported:
listenerCount(emitter, eventName)
defaultMaxListeners
errorMonitor
Node’s EventEmitter emitted a
newListener
event when a listener was added and aremoveListener
event when one was removed. These are not supported and will not be emitted.New features and improvements
isJavaScriptEnabled()
on a Puppeteerpage
to find out if JS is enabled on the page (#5993)Bug fixes
Ctrl-C
(#6011)Behind the scenes
Raw notes
5493494
- chore: mark version 4.0.003ab1c1
- fix: improve Ctrl + C support (#6011)b659969
- chore: migrate away from Node's EventEmitter (#5979)6e060ce
- fix(connection): separate send/receive debug logging (#6017)c701ea1
- chore: fix npm test command ([#6010](https://togithub.com/Configuration
📅 Schedule: At any time (no schedule defined).
🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.
♻️ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.
🔕 Ignore: Close this PR and you won't be reminded about this update again.
This PR has been generated by WhiteSource Renovate. View repository job log here.